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5 METHOD AND APPARATUS FOR AUTOMATICALLY GENERATING COMMON 
PARADIGMS IN COMPUTER SUPPORTED TELEPHONY APPLICATIONS 

(CSTA) PROTOCOLS 

BACKGROUND OF THE INVENTION 

10 

1 . Field of the Invention 

The invention relates to methods and apparatus 
for implementing computer supported telephony 
applications. More particularly, the invention relates 
15 to method and apparatus for automatically generating 
common paradigms in computer supported telephony 
applications (CSTA) protocols. 

2 . Brief Description of the Prior Art 

20 It is well known in the art to couple a 

computer to a PBX switch in order to provide enhanced 
telephony services. Such services include voice mail, 
fax on demand, text to speech email retrieval, call 
forwarding, interactive voice response systems, etc. 

25 Most of these applications are built around the CSTA 
standard which is a standard for the protocols used 
across the link between a computer and a PBX switch. The 
CSTA standard protocols utilize ASN.l, Abstract Syntax 
Notation number One, an international standard for 

30 specifying data used in communication protocols. 

Although ASN.l is powerful, it is a complex language. 



The CSTA standard has been implemented in various 
proprietary PBX-Computer interfaces such as the ""Call 
Bridge for Work Groups' 1 which is the interface used in 
the Siemens Hicom 300 PBX. 

5 

Although the CSTA has made the development of 
telephony application somewhat uniform, the protocols 
provided by the CSTA are relatively low level. Even with 
the "Call Bridge for Work Groups 11 interface, a telephony 

10 application must take responsibility for many low level 
functions of the interface. For example, even using the 
^Call Bridge for Work Groups' 1 interface, an application 
must take responsibility for creating, maintaining, and 
tearing down a TCP/IP socket connections; building and 

15 parsing the ASN. 1 encoded CSTA stream; handling the 

reception system status heartbeat messages; sending and 
handling the result of System Status heartbeat messages; 
and managing the generation and timing of invoke Ids. In 
addition, many applications would also want to add 

20 diagnostic user interface features to indicate status, 
statistics and errors as they pertain to a particular 
connection. All of these functions must be implemented 
by the application. Many of these, such as the ASN.l 
builder/parser are time-consuming and/or costly to 

25 develop/purchase . 
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It is known in the art to provide a higher 
level interface to some of the "Call Bridge for Work 
Groups" - CSTA interface. An earlier Siemens product^ 
provided limited ActiveX^support for the following CSTA \ 
Services: Monitor Start, Monitor^Stop , Divert Call, 


System Status Filter; and the following CSTA Events: 
connected, conferenced, connection cleared, delivered, 
diverted, established, held, agent logged off, agent 
10 logged on, network reached, agent not ready, queued, 

agent ready, retrieved, service initiated, transferred, 
agent work not ready, agent work ready, call info, 'system 
status, and universal failure error. However, there have 


r x nc^been any full high level interfaces addressing all of 
15 the featur es an d events of the 'Call Bridge for Work 

Groups" - CSTA interface. Moreover, there have not been 
,any_Jiigh level interface which aid in creation of common 
paradigms^used in telephony applications. Furthermore, 
there have not been any high level interfaces which aid 
20 in the provision of diagnostic functions in telephony 
applications . 
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SUMMARY OF THE INVENTION 


It is therefore an object of the invention to 
provide a high level control interface to CSTA protocols. 

It is also an object of the invention to 
provide a control interface which significantly reduces 
the development time and effort for creating telephony 
applications which interface with CSTA protocols. 

It is another object of the invention to 
provide a control interface which may be bypassed if the 
developer chooses to work directly with CSTA for certain 
functions . 

It is yet another object of the invention to 
provide a control interface based on an industry standard 
language which is easily incorporated into many different 
programming environments . 

It is another object of the invention to 
provide a control interface which frees the programmer 
from detailed knowledge of ASN.l. 

It is still another object of the invention to 
provide a control interface which is easily configurable. 


It is another object of the invention to 
provide a control interface which facilitates the easy 
creation of user interfaces. 

5 It is still another object of the invention to 

provide a control interface which provides easy to use 
diagnostic interfaces . 

In accord with these objects which will be 
10 discussed in detail below, the control interface 

according to the invention utilizes component based 
interface objects such as Microsoft ActiveX or Sun 
Microsystems JavaBeans to provide a high level interface 
to all of the "Call Bridge for Work Groups 11 - CSTA 
15 protocols. The presently preferred embodiment of the 

invention utilizes ActiveX. ActiveX controls generally 
include properties, methods, and events. According to 
the invention, the properties interface is used to set 
and get configuration values; the methods interface is 
20 used to initialize and shut down the control interface as 
well as to send CSTA messages to the control interface; 
and the events interface is used to transfer asynchronous 
data including CSTA events, data within events, CSTA 
responses, system status CSTA requests, and other control 
25 notifications. Property pages are also provided for 
implementing user interfaces and diagnostics. The 
control interface permits the automatic generation of 
common paradigms including: invoke ID generation, invoke 
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ID timing, send heartbeat messages, and reply to 
heartbeat messages. 

The control interface maintains a rich set of 
5 statistics including messages/sec, number of requests, 
number of responses, number of events, number of errors 
and number or rejects. All are tabulated on the incoming 
and outgoing link and all are displayable via a property 
page. Statuses are also displayable via a property page. 
10 Errors are logged internally by the control interface and 
can be displayed via a property page. Moreover, the 


g| control interface provides an ActiveX method by which 

m 

applications can log error information including 

f7 application defined error strings that are displayable 

15 via a property page. 

o 

riJ BRIEF DESCRIPTION OF THE DRAWINGS 


FIG. 1 is a high level block diagram of the 
20 platform architecture according to the invention 

including, the Call Bridge - CSTA interface of a PBX 
switch, the control interface of the invention, and an 
application generically referred to as a Tserver; and 

25 FIG. 2 is a high level block diagram of the 

control architecture of the invention illustrating the 
flow of data between the control interface of the 
invention and the Call Bridge - CSTA interface of a PBX 
switch. 
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DETAILED DESCRIPTION 


Turning now to Figure 1 # a platform 
architecture according to the invention includes the Call 
Bridge interface 10 of a PBX switch, the control 
interface 12, and a telephony application 14 referred to 
herein as Tserver. 

As mentioned above, the control interface 12 is 
preferably an ActiveX control that provides property, 
method and event interfaces to the application 14 on one 
side and a CSTA interface to Call Bridge 12 on the other 
side. In addition, property pages 16 are preferably 
provided to support such items as configuration, status 
and statistics viewing and error viewing as described in 
more detail below. 

The control interface 12 communicates with the 
Call Bridge 10 using the CSTA protocol via a TCP/IP based 
socket connection 18. As an ActiveX control, the control 
interface 12 provides three interfaces to the Tserver 14. 
These interfaces include the properties interface 20, the 
methods interface 22, and the events interface 24. The 
properties interface 20 is used to set and get 
configuration values. The methods interface 22 is used 
to initialize the control interface 12, shutdown the 
control interface 12 and to send CSTA messages to the 


control interface 12. The events interface 24 is used by 
the control interface 12 to send asynchronous data to the 
Tserver 14. These data include CSTA events (including 
data within the events) , CSTA responses, the System 
5 Status CSTA request and any other notifications that the 
control interface 12 needs to send. Property pages 16 
are provided and can be activated by the Tserver 
application via the appropriate method calls. 

10 Referring now to Figure 2, the internal 

Q architecture of the control interface 12 is shown 

ffi surrounded by phantom lines. The main processing 

{Uj component 2 6 handles any set and get property requests 

yT 20. It also handles methods 22, those related to 

s " 15 initialization and shutdown as well as those related to 

hf sending CSTA services. Where needed it will use the ASN.l 

y i 

fM parser 28 and builder 3 0 to receive and send CSTA 

O messages from/to the Call Bridge CSTA interface. 

According to the presently preferred embodiment, the Main 
20 Processing 26 and ASN.l components 28, 30 are 

implemented as part of the main thread of an ActiveX 

dynamically linked library (DLL) . 

As illustrated in Figure 2, all communications 
25 between the Call Bridge CSTA interface 18 and the main 
processing 26 is via the Winsock DLL 32. A socket 
connection is established upon which ASN.l encoded CSTA 
messages are sent and received to and from the Call 


ft? 

2 = 5 
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Bridge CSTA interface. According to the invention, a 
receive thread 34 will wait on the socket for a signal 
that indicates an incoming ASN.l encoded CSTA message. 
When such a message is received, the receive thread 34 
5 will post a message to the main thread and control is 
passed to the main thread. The main thread reads the 
CSTA message from the socket. The message is then parsed 
by the ASN.l parser component 28. Data from the parsed 
message is then sent to the Tserver 14 along with the 
10 notification of the arrival of the message. This is 
preferably accomplished in a single event call. 

According to the presently preferred 
embodiment, the ASN.l builder and parser components 
15 utilize the same Open Source Solutions (OSS components) 
as the Call Bridge CSTA interface. 

The control interface is preferably based on 
the MFC environment, utilizes an InprocServer32 type of 

20 ActiveX control, and supports the ActiveX apartment 

threading model. It will be appreciated that MFC based 
ActiveX controls must fire events from the main thread. 
This requirement is the reason the receive thread 34 
merely posts a message to the main thread 26 instead of 

25 handling the parsing of the message and the firing of the 
event itself. 
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The control interface according to the 
invention is preferably implemented with the Microsoft 
Developer studio through which a library of C-language 
files a re compiled. The following discussion includes a 
description of the various, properties, methods, events, 
and pages defined by the invention to implement the 
control interface . 

Properties 

The following are the major properties are used 
by the present invention: Call Bridge CSTA Port Number, 
Call Bridge CSTA Server Name, Control ID, and Error 
logging . 

The port number is a numeric representation of 
the Call Bridge CSTA port to which the control interface 
connects. The server name is a string that contains the 
host file name of the Call Bridge CSTA server. This 
scheme requires that an entry be made in the host file 
that contains the Call Bridge CSTA server name and its 
associated IP address. 

If the Tserver allows server name entry then 
the person running the application must know the Call 
Bridge CSTA server name. If the Tserver application does 
not allow server name entry then whatever hard coded 


10 


value it uses must be the name that is used in the host 
file* 

The Control ID is a string that identifies the 
5 type of the control interface. For this control 

interface, the string is CallBridge CSTA for Tservers and 
is read-only. 

The error logging property is a Boolean value 
10 that indicates whether or not the control interface 

should send internal error events to the application. 
These events are used to allow for debugging of the 
control interface. The default value of this property 
signifies that events should not be sent to the 
15 application. 

The control interface provides two methods for 
managing the control: one to initialize the connection 
and one to tear down the connection. 
20 ControlOpenConnection ( ) 

calls to FireControlConnectionOpen ( ) and 
ControlCloseConnection ( ) calls to 
FireControlConnectionClosed ( ) . 

25 In order to allow applications to differentiate 

between versions of the invention a new version property 
is used. The code for this property is similar to that 
of the Control ID Property with a BSTR value of the 
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format <major version> . <minor version>. 

According to the invention an option is 
provided for the control interface to send system status 
5 heartbeats to Callbridge CSTA and track the system status 
responses. This option is controlled via a new property, 
the heartbeat property. 

The Heartbeat property is similar to the Error 
_ 10 Logging property, and includes a Boolean flag that 
tfj enables or disables the heartbeat. The default is 

01 disabled. This property is persistent. 

FU The heartbeat implementation performs the 

O 15 following actions when enabled. After 30 seconds of 

y i 

fy inactivity on the incoming link it sends a System Status 

Q Enabled to Callbridge CSTA. If the reply comes within 10 

seconds then it starts the inactivity timer again. If 
the reply does not come within 10 seconds then it sends 
20 the FireControlLinkClosed ( ) event. Timers 1 and 2 are 
reserved for heartbeat timer usage. 

The present invention supports timed requests. 
If a response does not come back within a certain period 
25 of time an event will be fired indicating this condition. 
Timed requests are implemented as properties. These 
properties allow the user to enable request timing and to 
set the number of seconds that the control is to wait 
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before deeming that a response has been lost. The first 
property enables or disables the timing of requests. The 
second property assigns the time to wait for a response. 
This property will accept values from 10 seconds to 60 
5 seconds. The maximum of 60 seconds is partially 

determined by the implementation, system timers can only 
accept up to a maximum of 64 seconds. The lower 
threshold of 10 is to avoid values that can easily cause 
necessary timeouts under certain load conditions. Each 
10 of these properties is persistent. 

Q 

5 The internal invoke ID manager returns invoke 

Uy IDs in the range of 100 to OxFFFF (the UINT maximum) . 

H This value is then directly used as the timer ID for the 

= 15 SetTimer() routine. Timer values 1-99 are reserved for 

m possible future timer usages within the control 

hj interface. 

When a request is about to be sent, a timer is 
20 started with a timer ID equal to the invoke ID. The 
period of the timer is set from the Timed Requests 
property value. When a response, error, or reject is 
received, the parsed invoke ID (which equals the timer 
ID) is passed to the KillTimer() routine and no action is 
25 taken. If a timer times out, a message is sent to the 
WindowProc() with one of the parameters containing the 
timer ID (invoke ID) . In this situation, KillTimer() is 
called to free the timer and an event is sent that 
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contains the invoke ID. The event that will be used is 
FireUniversalError ( ) with a class of perf ormance_ errors 
and a value of perf ormanceLimi tExceeded . 

5 Methods 

The control interface supplies methods for CSTA 
service support as well as other peripheral support 
needed. 

10 It supports CSTA services via the following methods. All 
yg methods return the Invoke ID of the request if they 

On complete without any errors. Any negative value 

"fn indicates an error condition. 

p 1 5 MonitorStart ( ) 
S 5 § MonitorStop() 

a tit 

~ DivertCall ( ) , includes divert type and private user data 

~ parameter 

SystemStatus ( ) , includes cause parameter 

20 

AlternateCall ( ) , includes device ID to toggle, current 
call ID, and held call ID 

AnswerCall ( ) , includes answering call ID and answering 
device ID 

25 ChangeMonitorFilter ( ) , includes xref id, call filter, 
agent filter, feature filter, and maintenance filter 
ClearConnection( ) , includes call ID to clear, device ID 
to clear 
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ConferenceCall () , includes held call ID, held device ID, 
active call ID, and active device ID 

ConsultationCall ( ) , includes held call ID, held device 
ID, called device ID, private user-user data length, and 
5 private user-user data 

GenerateDigits, includes calling device ID and digits 
HoldCall(), includes call ID and device ID 

MakeCall(), includes originating device ID, called device 
ID, and auto-answer mode 
10 ReconnectCall ( ) , includes cleared call ID, cleared device 
q ID, retrieved call ID, and retrieved device ID 

m RetrieveCall ( ) , includes call ID and device ID 

Z] RouteTrigger ( ) , includes device ID and trigger 

rf RouteSelect ( ) , includes xref ID and device ID 

IU 15 RejectCall ( ) , includes xref ID 

y RouteEnd(), includes xref ID 

Tlj SingleStepTransf er ( ) , includes active call ID, active 

O device ID, transfer to device ID, private user-user data 

length, and private user-user data 
20 SnapshotDevice ( ) , includes device ID 

Transf erCall ( ) , includes held call ID, held device ID, 

active call ID, active device ID 

According to the presently preferred 
25 embodiment, query device requests are handled via 

separate methods, one for each type of query as listed 
below. 
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QueryDeviceDoNotDisturb() , includes device ID 
QueryDeviceFowarding ( ) , includes device ID 
QueryDeviceDevicelnf o ( ) , includes device ID 
QueryDeviceAgentState( ) , includes device ID 

According to the presently preferred 
embodiment, set feature requests are handled via separate 
methods, one for each type of feature as listed below. 

SetFeatureGroupAgent ( ) , includes device ID and state 
SetFeatureDoNotDisturb ( ) , includes device ID and state 
SetFeatureForwarding ( ) , includes device ID, type, 
forwarding DN, private type, private DN, and private 
system forwarding type 

SetFeatureAgentState ( ) , includes device ID, state, and 
group 

Several services support optional parameters. 
According to the presently preferred embodiment of the 
invention, the parameters are handled in the following 
manner. 

call ID - For any service that supports an optional call 
ID, the application should pass the value LONG -1 to 
indicate that the call ID is not present. 
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user-user data - For any service that supports user-user 
data a length parameter will also be provided. A 0 
length parameter indicates that the user-user data is not 
present . 

auto answer flag - This parameter is required on the make 
call request. 

filter - The optional filter parameter of the monitor 
start request is not exposed to the application. The 
application should use change monitor filter in order to 
change this value. 

The invention provides some unique parameter 
types for services as described below. 

user-user data - This field is thought of as a data byte 
stream. However, data byte streams are not easily passed 
between the application and Active-X controls. For this 
reason it is required that the application store the 
user-user data into a string (type BSTR in the control 
definition) . The control interface treats it not as a 
string but as a byte array of data that is as long as the 
accompanying length that the application has passed in. 

device IDs - If a device ID is a dialable number it is 
passed in as the ASCII representation of that dialable 
number. If a device ID is a device number it is passed 
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in as the '#' followed by the ASCII representation of the 
device number. 

The invention supports the following new 
service responses: SystemStatusResponse ( ) which includes 
invoke ID. 

The invention supports the following additional 
methods which are used to enable and disable the 
filtering of System Status requests that are received 
from Callbridge. 

ControlSystemStatusFilterStart ( ) 
ControlSystemStatusFilterStop ( ) 

The invention supports the following additional 
methods which are used to connect to and disconnect from 
the Callbridge gateway. 

ControlOpenConnection ( ) 
ControlCloseConnection ( ) 

The invention also provides a new method which 
is used to enable an application to log errors. 
Application generated errors are logged in the control 
error log and displayable with the control error log 
viewer . 
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Control LogError () , parameters include an error number, 
error code, information string, file name and line number 

Events 

The invention supports ActiveX events to handle 
CSTA events, CSTA services, CSTA responses and other 
control related events. The CSTA events are supported 
via the following ActiveX events. All events pass back 
the cross-reference ID. 

FireCalllnformationO , includes call ID, device ID, 
invoking device ID, account info length, and account info 

FireConf erenced ( ) , includes subject device ID, added 
device ID, primary call ID, primary device ID, secondary 
call ID, secondary device ID, conference ID list, local 
connection state, cause, private immediate connect to 
agent flag, and private cause 

FireConnectionCleared ( ) , includes dropped call ID, 
dropped device ID, releasing device ID, local connection 
state, and cause 

FireDelivered ( ) , includes call ID, device ID, alerting 
device ID, calling device ID, called device ID, last 
redirect device ID, private held device ID, local 
connection state, cause, private ANI flag, private 
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user-user data length, private user-user data, private 
trunk, and private ACD DN 

FireDiverted( ) , includes diverted call ID, diverted 
5 device ID, diverting device ID, destination device ID, 
local connection state, and cause 

FireEstahlished ( ) , includes answered call ID, answered 
device ID, answering device ID, calling device ID, called 
10 device ID, last redirect device ID, private held call ID, 
local connection state, and cause 

FireHeld(), includes held call ID, held device ID, 
holding device ID, local connection state, cause, and 
15 private cause 

FireNetworkReached ( ) , includes call ID, device ID, trunk, 
called device ID, local connection state, and cause 

20 FireQueued() , includes queued call ID, queued device ID, 
queue device ID, calling device ID, called device ID, 
last redirect device ID, private held device ID, local 
connection state, and cause 

25 FireRetrieved( ) , includes retrieved call ID, retrieved 
device ID, retrieving device ID, local connection state, 
and cause 
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FireServicelnitiated ( ) , includes new call ID, new device 
ID, requested device ID, and local connection state 

FireTransf erred ( ) , includes primary old call ID, primary 
old device ID, secondary old call ID, secondary old 
device ID, transferring device ID, transf erred-to device 
ID, new call ID, new device ID, local connection state, 
cause, private cause, private user-user data length, and 
private user-user data 

FireAgentLoggedOn ( ) , includes agent device ID, agent ID, 
and group ID 

FireAgentLoggedOf f ( ) , includes agent device ID, agent ID, 
and group ID 

FireAgentReady ( ) , includes agent device Id 

FireAgentNotReady ( ) , includes agent device ID 

FireAgentWorkNotReady ( ) , includes agent device ID 

FireDoNotDisturb ( ) , includes device ID and state 

FireFailed ( ) , includes call ID, device ID, called device 
ID, local connection state, and cause 
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FireForwarding ( ) - device ID, forward type, forward DN, 
private forward type, private forward DN 

FireOriginated ( ) - originating call ID, originating 
device ID, called device ID, local connection state, 
cause 

Several events support optional parameters. 
These parameters are handled in the following manner. 

Local connection state - The value SHORT -1 is returned 
if this optional field is not present. 

cause - The value SHORT -1 is returned if this optional 
held is not present. 

private cause - The value SHORT -1 is returned if this 
optional field is not present. 

immediate connect to agent flag - This field supports 
three values: SHORT 0 indicates a FALSE condition, SHORT 
1 indicates a TRUE condition, and SHORT -1 indicates a 
not present condition. 

ANI flag - This field supports three values: SHORT 0 
indicates a FALSE condition, SHORT 1 indicates a TRUE 
condition, and SHORT -1 indicates a not present 
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condition. 

trunk number - The value LONG -1 is returned if this 
optional held is not present. 

private forwarding type - This field supports three 
values: SHORT 0 indicates a FALSE condition, SHORT 1 
indicates a TRUE condition, and SHORT -1 indicates a not 
present condition . 

private forwarding DN - The value 1,11 (a NULL string) is 
returned if this optional field is not present. 

ACD DN - The value 1,11 (a NULL string) is returned if this 
optional field is not present. 

device IDs - In any instance where the dialable number or 
device number is not present the value 11 " (a NULL string) 
is returned. 

The invention provides the following unique 
parameters for events. 

user-user data - This is the same as the parameter 
described above with regard to services. 
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conference list - This parameter is encoded in the 
following format: <ASCII call ID>,<ASCII device 
ID>/<ASCII call ID>,<ASCII device ID>/ . . . 

5 

device IDs - If a device ID is a dialable number it is 
returned as the ASCII representation of that dialable 
number. If a device ID is a device number it is returned 
as the ' #• followed by the ASCII representation of the 
10 device number . 

The invention supports control events via the 
following ActiveX events. 

15 The following events are used to indicate 

System Status filtering conditions. 

FireControlFilterStartResult ( ) 
FireControlFilterStopResult ( ) 

20 

The following events are used to indicate the 
status of the connection to Callbridge. 

FireControlConnectionOpen ( ) 
25 FireControlConnectionClosed ( ) 
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The invention supports the receiving of the 
following CSTA services from Callbridge CSTA. These 
services are supported via the following ActiveX events, 

5 

FireSystemStatusService, includes invoke ID, and type 

FireRouteEndService ( ) , includes xref ID, and private 
cause 

10 

D 

*5 RouteRequestService ( ) , includes xref ID, called device 

ID, calling device ID, routed call ID, and routed device 

1 1 i - 

-p ID 

2 

p 15 ReRouteRequestService ( ) , includes xref ID 

y 

a The invention supports CSTA responses via the 

following ActiveX events. All results return the invoke 
ID, 

20 

FireSystemStatusReqResult ( ) 


FireMonitorStartResult ( ) , includes call filter, agent 
filter, feature filter, and maintenance filter 

25 

FireMonitorStopResult ( ) 
FireDivertCallResult ( ) 

25 


FireUniversalError ( ) , passes back the class and value 
values instead of just a single error code. The Invoke 
ID is also passed back. 

5 

FireReject ( ) , passes back the class and value values 
instead of just a single error code. The Invoke ID is 
also passed back. 

10 FireAlternateCallResult ( ) 

FireAnswerCallResult ( ) 

FireChangeMonitorFiiterResult ( ) , includes call filter, 
15 agent filter, feature filter, and maintenance filter 

FireClearConnectionResult ( ) 

FireConf erenceCallResult ( ) , includes new call ID and new 
20 device ID 

FireConsultationCallResult ( ) , includes new call ID and 
new device ID 

25 FireGenerateDigitsResult ( ) 

FireHoldCallResult ( ) 
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FireMakeCallResult () , includes new call ID and new device 
ID 

5 FireQueryDoNotDisturbResult () , includes state 

FireQueryFowardingResult ( ) , includes type count, type 
list, DN list, private type count, private type list, and 
private DN list 

FireQueryDevicelnf oResult ( ) , includes device ID, type, 
private type, private sub-type, private attribute, and 
calls queued 

15 FireQueryAgentStateResult ( ) , includes state, agent ID, 
group 

FireReconnectCallResult ( ) 
20 FireRetrieveCallResult () 

FireSetFeatGroupAgentResult ( ) 
FireSetFeatDNDResult ( ) 

25 

FireSetFeatFwdResult ( ) 
FireSetFeatAgentStateResult ( ) 
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FireSingleStepXf erStateResult ( ) , includes transferred 
call ID and transferred device ID 

FireSnapshotDeviceResult ( ) , includes call ID 1 through 
call ID 5 and local connection state 1 through local 
connection state 5 

FireSystemStatusResult ( ) 

FireTransf erCallResult ( ) , includes new call ID and new 
device ID 

The invention provides the following unique 
parameters for responses . 

DN lists - The query device forwarding response may 
contain two DN lists, one for each forwarding type 
present and one for each private forwarding type present. 
The DN list format is the ASCII equivalent of the device 
ID separated by commas with each double entry followed by 
a single slash: <ASCII device ID>/<ASCII device ID>/... 

type lists - The query device forwarding response may 
contain up to 20 different forwarding types. Normally 
these would be represented each as a separate short 
parameter but Active-X controls have a limit and do not 
allow 22 parameters to be passed back in events. Because 
of this, the forwarding types and the private forwarding 
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types are encoded into a BSTR parameter. The encoding 
format is the ASCII equivalent of the forwarding type 
separated by commas. The last entry is not followed by 
comma. A length field is returned equal to the number o 
types . 

<ASCII type> / <ASCII type> , . . . <ASCII type> 

The control framework provided by Microsoft 
includes several methods which can be overridden to 
provide certain actions. The invention overrides the 
OnDraw() function to provide a bitmapped display for the 
control. In particular, the invention provides two 
bitmaps. One is used for toolbar type displays and one 
is used display when the control is inserted into an 
application . 

The WindowProc ( ) routine is where the messages 
are received and where link error conditions are handled 
This routine uses FireLinkConnectionClosed ( ) . 

The process_xxx routines handle the parsing of 
the incoming CSTA message. According to the invention, 
these routines handle the new CSTA messages, additional 
information and parameters that are to be passed in the 
ActiveX events described above. 
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As mentioned above, the invention supports 
ActiveX apartment threading. This is implemented via the 
following code: 

5 

BOOL 

CCbCstaCtrl: : CCbCstaCtrlFactory : : UpdateRegistry (BOOLbRegi 

ster) 

{ 

10 // TODO: Verify that your control follows apartment-model 
threading rules. 

// Refer to MFC TechNote 64 for more information. 
// If your control does not conform to the 
apartment-model rules, then 
15 // you must modify the code below, changing the 6th 
parameter from 

// af xRegApartmentThreading to 0. 
if (bRegister) 

return Af xOleRegisterControlClass ( 
20 Af xGetlnstanceHandle ( ) , 

m_clsid, 

m_lpszProgID, 

IDS_CBCSTA, 

IDB_CSTA, 
25 af xRegApartmentThreading, 

_dwCbCsta01eMisc , 

_tlid 

_wVerMajor , 
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_wVerMinor) ; 

else 

return Af xOleUnregisterClass (m_clsid , m_lpszProgID) ; 

} 

Apartment threading allows multiple instances 
of a control within a single process. When instantiated 
in this manner, each instance of the control will attempt 
to form a separate connection with a Callbridge server. 
By using the server name and port properties on each 
control it is possible to have controls within the same 
process connects as different hosts connected to the same 
Callbridge server or different hosts connected to 
different Callbridge servers. 

Property Pages 

According to the invention, support has been 
added to collect a number of different statuses and 
statistics- All statuses and statistics to be kept are 
defined below and are displayable via new property pages. 
The purpose of these property pages are to provide 
methods for allowing a quick glance at items that show 
how the control interface is operating. These pages are 
mainly intended for support purposes. According to the 
presently preferred embodiment, four property pages are 
provided: the link status page, the statistics page, the 
error viewing property page, and the configuration 


31 


m 


property page. 

The link status page includes the following 
information. 

5 

For the Callbridge link: 

1. Link Status - Connected or Not Connected, 

2. Link Down Count - number of times link has been 

down , 

10 3. Link Up Count - number of times link has been 

brought up . 

For the Application link: 

1. Link Status - Connected or Not Connected, 
15 2. Event Acceptance State - Frozen or Unfrozen. 

For heartbeat messages sent by Callbridge to the control 
interface : 

1. Heartbeats Received - number of System Status 
20 Normals received from Callbridge CSTA, 

2. Heartbeats Acked - number of heartbeat messages 
acknowledged . 

For heartbeat messages sent to Callbridge from the 
25 control interface: 

1. Heartbeats Sent - Number of System Status Normals 
sent to Callbridge CSTA, 
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2 . Heartbeats Acked - number of heartbeat messages 
acknowledged , 

3. Heartbeats Failed - number of heartbeat messages 
not acknowledged. 

The link status property page has a Clear 
button that will clear all the above items except the 
Link Statuses and Event Acceptance State. According to 
the presently preferred embodiment, all items on the link 
status property page are updated every 10 seconds. 

The statistics property page includes the 
following information: 

1. CSTA Requests, responses, errors, rejects and 
events received, 

2. CSTA Requests, responses, errors, rejects and 
events sent, 

3. Messages per second received, 

4. Messages per second sent. 

The statistics property page has a Clear button 
that will clear all the above items. According to the 
presently preferred embodiment, all items on the 
statistics property page are updated every 10 seconds. 

Before discussing the error viewing page, the 
error logging according to the invention will be 
discussed. According to the invention, internal errors 
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may be sent to an application via events if the error the 
logging property is set to TRUE. In addition a simple 
error log is maintained. 

The su_log_message ( ) takes error message 
information and writes an ASCII representation to a 
circular file. This implementation has the following 
characteristics: The file has a fixed size. The file 
resides in the system directory. The file will is named 
CSTA_TSERVER_ERROR_LOG.LOG. The file will is viewable 
via a simple text editor. The file is viewable via the 
error log property page. 

If error logging is implemented, a property 
page is provided that allows a user to view the error 
log. The error viewing property page has the following 
characteristics : 

1. Error entries are displayed in a tree view 
format , 

2. Error details are expandable/contract ible , 

3. A refresh button allows the display to be 
refreshed . 

In addition, the following strings are used by the 
error viewing property page: 

IDS CBCSTATSERVER PPG ERROR VIEW Error Viewing Property 
Page 

IDS CBCSTATSERVER PPG ERROR VIEW CAPTION Error Viewing 


The configuration property page provides an 
interface for setting and viewing all properties. This 
property page displays all properties and allows 
read/write properties to be changed. The following 
strings will be created for this property page. 
IDS CBCSTATSERVER PPG CONFIG 
IDS CBCSTATSERVER_PPG_CONFIG_CAPTION 

There have been described and illustrated 
herein methods and apparatus for a control interface for 
CSTA protocols. While particular embodiments of the 
invention have been described , it is not intended that 
the invention be limited thereto, as it is intended that 
the invention be as broad in scope as the art will allow 
and that the specification be read likewise. It will 
therefore be appreciated by those skilled in the art that 
yet other modifications could be made to the provided 
invention without deviating from its spirit and scope as 
so claimed. 
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